home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / masdir54.zip / SDLSETUP.DOC < prev    next >
Text File  |  1991-03-17  |  10KB  |  194 lines
  1.        
  2.  
  3.      SDLSETUP.BAT - DOCUMENTATION - Copyright 1987-1991 Bob Stephan
  4.      * * *
  5.      You will be able to browse through the SDLSETUP documentation at 
  6.      your own pace.  Just use the keys on the cursor pad to turn the 
  7.      pages as you read.  Note the reminder at the top of the screen, 
  8.      and remember that you can exit at any time by pressing Esc.
  9.      * * *
  10.      SDLSETUP will not modify any of your original files.  Only 
  11.      SDL.COM will be affected.  In particular, your CONFIG.SYS and 
  12.      AUTOEXEC.BAT will not be touched.
  13.      * * *
  14.      NOTE:  A menu facility and more options have been added to 
  15.      SDLSETUP.  This makes it more "user-friendly" and self- 
  16.      documenting. Therefore this documentation has been reduced in 
  17.      size to cover just a few essential points.  Now that many 
  18.      defaults can be more conveniently set with the DOS SET command, 
  19.      future versions of SDLSETUP may have a reduced number of options.
  20.  
  21.           (Press the PgDn key to continue)
  22.  
  23.  
  24.      Documentation for SDLSETUP.BAT for SDL Version 5, March 1991
  25.      Copyright 1987-1991 Bob Stephan and MOBY DISK.
  26.  
  27.      SDLSETUP is a handy program to customize many of the options of 
  28.      SDL.COM, the Sorted Directory and disk Label printing program. 
  29.      It requires only that you answer a series of questions with 
  30.      single keystroke responses and, if desired, input new titles to 
  31.      appear in the top two lines of the directory display.
  32.  
  33.      The easiest way to run SDLSETUP is to establish a working disk or 
  34.      directory (a RAM disk will be fastest, a directory on a hard disk 
  35.      next, and a floppy can be quite slow).  Enter the following 
  36.      command to copy the necessary files from the MASDIR diskette to 
  37.      your working area.  Assume that the MASDIR diskette is in drive 
  38.      B: and that your RAM disk is drive D:.  Then just enter
  39.  
  40.          COPY B:SDL*.* D:
  41.  
  42.      Remember to adjust the drive letters for your system.  You can 
  43.      add the path after D: if you so desire, or just issue this 
  44.      command after changing to the working disk or directory.  You can 
  45.      use INSTALL to help you do this if you like.  Enter INSTALL at 
  46.      the DOS prompt for your MASDIR working disk and follow the 
  47.      instructions.
  48.  
  49.      The questions in SDLSETUP are self-explanatory and should cause 
  50.      no confusion.  A few of them are explained in a little more 
  51.      detail here.  If you have any questions, read on, and then if you 
  52.      still have questions after running SDLSETUP please contact me.
  53.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  54.      After establishing your working disk or directory, enter the 
  55.      command:
  56.                                -2-
  57.  
  58.  
  59.      SDLSETUP
  60.      * * *
  61.      The first thing SDLSETUP does is check system resources. At this 
  62.      point SDLSETUP is looking for the DOS DEBUG external command file 
  63.      DEBUG.COM.  If it is not found you will see the message "Bad 
  64.      command or file name".  This will be followed by a beep and an 
  65.      explanatory message.  SDLSETUP cannot work without DEBUG, or in 
  66.      the case of DR DOS, SID.COM. It must be in the current directory 
  67.      or in one of the directories on your path.  At this point your 
  68.      PATH will be displayed so you can see what is included, and 
  69.      SDLSETUP will exit back to the DOS prompt.
  70.  
  71.      If DEBUG is found, SDLSETUP will check for the presence of other 
  72.      necesary files.  Depending on what is found you may see some 
  73.      explanatory messages.  If you don't see them, then all is well.
  74.  
  75.      (REM: One user reported a problem during this portion of the 
  76.      setup program, and it turned out that he was running a RAM 
  77.      resident program (TSR) named DOSEDIT.  This appeared to interfere 
  78.      with the redirected input to DEBUG.  The solution was just to 
  79.      boot the computer without DOSEDIT temporarily while running 
  80.      SDLSETUP.)
  81.  
  82.      Next the DOS version will be checked.  If it is found to be 
  83.      version 2.x you will see a message.  Please see the note at the 
  84.      end of this DOC file if you are using an early version of DOS.
  85.      * * *
  86.      Remember, you can exit from SDLSETUP at any time by pressing 
  87.      Ctrl-C or Ctrl-Break.
  88.      * * *
  89.      SDLSETUP has two sets of menus from which you can choose which 
  90.      features you want to customize.  At each menu, if you make no 
  91.      selection by just pressing Esc or Enter, you will proceed on to 
  92.      the next menu.  Some selections will lead to related options, so 
  93.      if you don't see exactly what you want, select the closest item 
  94.      and see if it will lead you to where you want to go.
  95.  
  96.      In Version 5 the defaults for the selections on the first 
  97.      SDLSETUP menu can simply be set with the DOS SET command.  This 
  98.      makes it convenient to set options "on the fly" without going 
  99.      through all the details of SDLSETUP.  If the option is a "command 
  100.      line" option (indicated by the / switch character), it can be set 
  101.      directly from DOS.  Read the documentation for more information 
  102.      on setting defaults in this manner.  Please let me know if you 
  103.      like this feature and if you would prefer to reduce the number of 
  104.      items in SDLSETUP to just those that cannot be set with the SET 
  105.      command.
  106.  
  107.      There are a few defaults that can only be modified in SDLSETUP. 
  108.      These are on the second menu, so you can just press Enter for the 
  109.      first menu if that is all you want to change.  Registered users
  110.                                -3-
  111.  
  112.      can also customize the first two header lines of the directory 
  113.      display to include personal or business identification.  These 
  114.      two lines plus a third line can be used for describing the files 
  115.      on a disk with the E(ntitle) option when runing SDL.  The best 
  116.      procedure is to make a quick run through SDLSETUP to see for 
  117.      yourself which items are on the menus so you can decide whether 
  118.      you want or need to run SDLSETUP.  If you are satisfied with the 
  119.      way SDL displays your directories and prints, and with setting 
  120.      your defaults with SET, then you probably don't need to run 
  121.      SDLSETUP at all.
  122.  
  123.      If you are evaluating the shareware version of MASDIR, you will 
  124.      want to run SDLSETUP to eliminate the moving line of text 
  125.      containing the information about registration.  SDLSETUP will 
  126.      adjust SDL.COM to turn off the moving message for a 30 day 
  127.      evaluation period.  After that time it will reappear to remind 
  128.      you that you are using an evaluation copy.  There is nothing to 
  129.      prevent you from running SDLSETUP as many times as you want to 
  130.      suppress this reminder message, but if you find that you like 
  131.      SDL.COM that well, you should obtain a registered copy from the 
  132.      author.  Your support of shareware authors will enable the 
  133.      continued development of this kind of quality, low cost software.
  134.  
  135.      If everything completes normally you will see the message...
  136.  
  137.      SDL.COM has been modified.
  138.      Don't forget to COPY your new version of SDL.COM
  139.      to the disk and/or directory with your other DOS
  140.      commands and utilities.
  141.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  142.      That's all there is to it, so enjoy using SDL with your own 
  143.      configuration.
  144.  
  145.      SDLSETUP creates one or two working files named SDLSETUP.TXT and 
  146.      SDLTITLE.TXT.  These files will be erased when SDLSETUP is 
  147.      finished with its work.
  148.  
  149.      NOTE:  If you run into a problem running SDLSETUP under DOS 2.1 
  150.      read this section.  Generally it works fine, and I can detect no 
  151.      problems under DOS 3 or later, but if you see either of the 
  152.      messages "EXEC failure" or "File creation error" please let me 
  153.      know.  You might try increasing the "FILES=" value in your 
  154.      CONFIG.SYS file and reboot.  A remote possibility is that the 
  155.      directory is full, so you might try running it on a different 
  156.      drive or in a different directory.  You can also run CHKDSK to 
  157.      see if there are any other conditions that might cause the error. 
  158.      This seems to be caused by a problem with DOS 2.1 in the number 
  159.      of open files it thinks it has.  One method that some have used 
  160.      successfully to work around this is to make only one or two 
  161.      changes to the defaults on each invocation of SDLSETUP.  If this 
  162.      works, you will have to reboot your computer before you can run 
  163.      SDLSETUP again. This may be tedious, but it is one way to use
  164.                                -4-
  165.  
  166.      SDLSETUP with DOS 2.1. Be sure to use the Esc key to skip the 
  167.      sections in which you are not making changes.
  168.  
  169.      This problem is apparently caused by a bug or deficiency in DOS 
  170.      2.1, but I have included a work-around for it.  If you see either 
  171.      of the above messages, AND if SDLSETUP has finished all of its 
  172.      questions through the ones about changing the titles, then reboot 
  173.      with Ctrl-Alt-Del and get back to the drive and directory in 
  174.      which you were running SDLSETUP.  (If you are working on a RAM 
  175.      disk, copy your work to a permanent disk first.) One or two of 
  176.      the .TXT files named above should be in that directory (2 if you 
  177.      changed titles, otherwise only the first one).  If you see 
  178.      SDLSETUP.TXT you can run SDLDEBUG, the last batch file in the 
  179.      series.  This should install your changes and clean up after 
  180.      itself.  See the CAUTION above about other types of problems.  I 
  181.      apologize for any inconvenience, but it is a problem beyond my 
  182.      control.
  183.  
  184.      (CAUTION: Do NOT run SDLDEBUG if there has been any other error 
  185.      or interruption.  In that case it is safer to start over again. 
  186.      SDLDEBUG uses redirection and if the input file SDLSETUP.TXT has 
  187.      not been completed, it can cause a hangup that will require a 
  188.      reboot.)
  189.  
  190.      As a last resort, run SDLSETUP on a machine that is running DOS 
  191.      3.0 or later.  Then copy the resulting SDL.COM to your machine. 
  192.      Good luck!
  193.  
  194.           Now, if you want to exit, remember to press Esc.